home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / pp / pp-6.0 / doc / manual / volume2 / volume2.tex / node46_ct.html < prev    next >
LaTeX Document  |  1991-12-01  |  6.1 KB

open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: LaTeX Document (document/latex).

ConfidenceProgramDetectionMatch TypeSupport
100% dexvert LaTeX Document (document/latex) magic Supported
90% dexvert Hypertext Markup Language File (text/html) magic Supported
1% dexvert Text File (text/txt) fallback Supported
100% file HTML document text default (weak)
99% file LaTeX document text default
98% file exported SGML document text default
97% file C source text default
96% file exported SGML document, ASCII text default
80% TrID HyperText Markup Language with DOCTYPE default
19% TrID HyperText Markup Language default
100% checkBytes Printable ASCII default
100% perlTextCheck Likely Text (Perl) default
100% siegfried fmt/281 LaTeX (Subdocument) default
100% gt2 HTML (Hyper Text Markup Language) Datei default
100% detectItEasy Format: Plain text[LF] default
100% xdgMime text/html default



hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 3c 21 44 4f 43 54 59 50 | 45 20 48 54 4d 4c 20 50 |<!DOCTYP|E HTML P|
|00000010| 55 42 4c 49 43 20 22 2d | 2f 2f 57 33 43 2f 2f 44 |UBLIC "-|//W3C//D|
|00000020| 54 44 20 48 54 4d 4c 20 | 33 2e 32 20 46 69 6e 61 |TD HTML |3.2 Fina|
|00000030| 6c 2f 2f 65 6e 22 3e 0a | 0a 3c 21 2d 2d 43 6f 6e |l//en">.|.<!--Con|
|00000040| 76 65 72 74 65 64 20 77 | 69 74 68 20 4c 61 54 65 |verted w|ith LaTe|
|00000050| 58 32 48 54 4d 4c 20 32 | 30 32 32 20 28 52 65 6c |X2HTML 2|022 (Rel|
|00000060| 65 61 73 65 64 20 4a 61 | 6e 75 61 72 79 20 31 2c |eased Ja|nuary 1,|
|00000070| 20 32 30 32 32 29 20 2d | 2d 3e 0a 3c 48 54 4d 4c | 2022) -|->.<HTML|
|00000080| 20 6c 61 6e 67 3d 22 65 | 6e 22 3e 0a 3c 48 45 41 | lang="e|n">.<HEA|
|00000090| 44 3e 0a 3c 54 49 54 4c | 45 3e 43 6f 6e 74 65 6e |D>.<TITL|E>Conten|
|000000a0| 74 73 20 6f 66 20 51 75 | 65 75 65 20 4d 61 6e 61 |ts of Qu|eue Mana|
|000000b0| 67 65 72 20 49 6e 74 65 | 72 61 63 74 69 6f 6e 3c |ger Inte|raction<|
|000000c0| 2f 54 49 54 4c 45 3e 0a | 0a 3c 4d 45 54 41 20 48 |/TITLE>.|.<META H|
|000000d0| 54 54 50 2d 45 51 55 49 | 56 3d 22 43 6f 6e 74 65 |TTP-EQUI|V="Conte|
|000000e0| 6e 74 2d 54 79 70 65 22 | 20 43 4f 4e 54 45 4e 54 |nt-Type"| CONTENT|
|000000f0| 3d 22 74 65 78 74 2f 68 | 74 6d 6c 3b 20 63 68 61 |="text/h|tml; cha|
|00000100| 72 73 65 74 3d 75 74 66 | 2d 38 22 3e 0a 3c 4d 45 |rset=utf|-8">.<ME|
|00000110| 54 41 20 4e 41 4d 45 3d | 22 76 69 65 77 70 6f 72 |TA NAME=|"viewpor|
|00000120| 74 22 20 43 4f 4e 54 45 | 4e 54 3d 22 77 69 64 74 |t" CONTE|NT="widt|
|00000130| 68 3d 64 65 76 69 63 65 | 2d 77 69 64 74 68 2c 20 |h=device|-width, |
|00000140| 69 6e 69 74 69 61 6c 2d | 73 63 61 6c 65 3d 31 2e |initial-|scale=1.|
|00000150| 30 22 3e 0a 3c 4d 45 54 | 41 20 4e 41 4d 45 3d 22 |0">.<MET|A NAME="|
|00000160| 47 65 6e 65 72 61 74 6f | 72 22 20 43 4f 4e 54 45 |Generato|r" CONTE|
|00000170| 4e 54 3d 22 4c 61 54 65 | 58 32 48 54 4d 4c 20 76 |NT="LaTe|X2HTML v|
|00000180| 32 30 32 32 22 3e 0a 0a | 3c 4c 49 4e 4b 20 52 45 |2022">..|<LINK RE|
|00000190| 4c 3d 22 53 54 59 4c 45 | 53 48 45 45 54 22 20 48 |L="STYLE|SHEET" H|
|000001a0| 52 45 46 3d 22 76 6f 6c | 75 6d 65 32 2e 63 73 73 |REF="vol|ume2.css|
|000001b0| 22 3e 0a 0a 3c 4c 49 4e | 4b 20 52 45 4c 3d 22 6e |">..<LIN|K REL="n|
|000001c0| 65 78 74 22 20 48 52 45 | 46 3d 22 6e 6f 64 65 34 |ext" HRE|F="node4|
|000001d0| 37 5f 6d 6e 2e 68 74 6d | 6c 22 3e 0a 3c 4c 49 4e |7_mn.htm|l">.<LIN|
|000001e0| 4b 20 52 45 4c 3d 22 70 | 72 65 76 69 6f 75 73 22 |K REL="p|revious"|
|000001f0| 20 48 52 45 46 3d 22 6e | 6f 64 65 34 35 5f 6d 6e | HREF="n|ode45_mn|
|00000200| 2e 68 74 6d 6c 22 3e 0a | 3c 4c 49 4e 4b 20 52 45 |.html">.|<LINK RE|
|00000210| 4c 3d 22 75 70 22 20 48 | 52 45 46 3d 22 6e 6f 64 |L="up" H|REF="nod|
|00000220| 65 34 35 5f 6d 6e 2e 68 | 74 6d 6c 22 3e 0a 3c 4c |e45_mn.h|tml">.<L|
|00000230| 49 4e 4b 20 52 45 4c 3d | 22 6e 65 78 74 22 20 48 |INK REL=|"next" H|
|00000240| 52 45 46 3d 22 6e 6f 64 | 65 34 37 5f 6d 6e 2e 68 |REF="nod|e47_mn.h|
|00000250| 74 6d 6c 22 3e 0a 3c 2f | 48 45 41 44 3e 0a 20 0a |tml">.</|HEAD>. .|
|00000260| 3c 42 4f 44 59 20 62 67 | 63 6f 6c 6f 72 3d 22 23 |<BODY bg|color="#|
|00000270| 66 66 66 66 66 66 22 20 | 74 65 78 74 3d 22 23 30 |ffffff" |text="#0|
|00000280| 30 30 30 30 30 22 20 6c | 69 6e 6b 3d 22 23 39 39 |00000" l|ink="#99|
|00000290| 34 34 45 45 22 20 76 6c | 69 6e 6b 3d 22 23 30 30 |44EE" vl|ink="#00|
|000002a0| 30 30 66 66 22 20 61 6c | 69 6e 6b 3d 22 23 30 30 |00ff" al|ink="#00|
|000002b0| 66 66 30 30 22 3e 0a 0a | 3c 48 33 3e 3c 41 20 49 |ff00">..|<H3><A I|
|000002c0| 44 3d 22 53 45 43 54 49 | 4f 4e 30 30 37 32 32 31 |D="SECTI|ON007221|
|000002d0| 30 30 30 30 30 30 30 30 | 30 30 30 30 30 30 22 3e |00000000|000000">|
|000002e0| 0a 51 75 65 75 65 20 4d | 61 6e 61 67 65 72 20 49 |.Queue M|anager I|
|000002f0| 6e 74 65 72 61 63 74 69 | 6f 6e 3c 2f 41 3e 0a 3c |nteracti|on</A>.<|
|00000300| 2f 48 33 3e 0a 0a 3c 50 | 3e 0a 54 68 65 20 71 75 |/H3>..<P|>.The qu|
|00000310| 65 75 65 20 6d 61 6e 61 | 67 65 72 20 69 6e 74 65 |eue mana|ger inte|
|00000320| 72 61 63 74 69 6f 6e 20 | 69 73 20 6e 6f 72 6d 61 |raction |is norma|
|00000330| 6c 6c 79 20 68 61 6e 64 | 6c 65 64 20 62 79 20 61 |lly hand|led by a|
|00000340| 20 73 69 6e 67 6c 65 0a | 70 72 6f 63 65 64 75 72 | single.|procedur|
|00000350| 65 2c 20 0a 3c 42 52 3e | 3c 63 6f 64 65 3e 63 68 |e, .<BR>|<code>ch|
|00000360| 61 6e 6e 65 6c 5f 63 6f | 6e 74 72 6f 6c 3c 2f 63 |annel_co|ntrol</c|
|00000370| 6f 64 65 3e 2c 20 77 68 | 69 63 68 20 6d 61 6e 61 |ode>, wh|ich mana|
|00000380| 67 65 73 20 74 68 65 20 | 73 65 73 73 69 6f 6e 20 |ges the |session |
|00000390| 77 69 74 68 20 74 68 65 | 0a 51 4d 47 52 20 61 6e |with the|.QMGR an|
|000003a0| 64 20 63 61 6c 6c 73 20 | 74 68 65 20 61 70 70 72 |d calls |the appr|
|000003b0| 6f 70 72 69 61 74 65 20 | 72 6f 75 74 69 6e 65 73 |opriate |routines|
|000003c0| 20 6f 6e 20 72 65 63 65 | 69 70 74 20 6f 66 20 52 | on rece|ipt of R|
|000003d0| 4f 53 20 6f 70 65 72 61 | 74 69 6f 6e 73 2e 0a 0a |OS opera|tions...|
|000003e0| 3c 50 3e 0a 3c 42 4c 4f | 43 4b 51 55 4f 54 45 3e |<P>.<BLO|CKQUOTE>|
|000003f0| 0a 3c 41 20 49 44 3d 22 | 31 33 39 34 22 3e 3c 2f |.<A ID="|1394"></|
|00000400| 41 3e 3c 2f 42 4c 4f 43 | 4b 51 55 4f 54 45 3e 3c |A></BLOC|KQUOTE><|
|00000410| 50 52 45 3e 0a 69 6e 74 | 20 63 68 61 6e 6e 65 6c |PRE>.int| channel|
|00000420| 5f 63 6f 6e 74 72 6f 6c | 20 28 61 72 67 63 2c 20 |_control| (argc, |
|00000430| 61 72 67 76 2c 20 69 6e | 69 74 66 6e 78 2c 20 0a |argv, in|itfnx, .|
|00000440| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000450| 20 20 20 20 20 70 72 6f | 63 66 6e 78 2c 20 65 6e | pro|cfnx, en|
|00000460| 64 66 6e 78 29 0a 69 6e | 74 20 20 20 20 61 72 67 |dfnx).in|t arg|
|00000470| 63 3b 0a 63 68 61 72 20 | 20 20 2a 2a 61 72 67 76 |c;.char | **argv|
|00000480| 3b 0a 49 46 50 20 20 20 | 20 69 6e 69 74 66 6e 78 |;.IFP | initfnx|
|00000490| 3b 0a 73 74 72 75 63 74 | 20 74 79 70 65 5f 51 6d |;.struct| type_Qm|
|000004a0| 67 72 5f 44 65 6c 69 76 | 65 72 79 53 74 61 74 75 |gr_Deliv|eryStatu|
|000004b0| 73 20 20 20 2a 28 2a 70 | 72 6f 63 66 6e 78 29 28 |s *(*p|rocfnx)(|
|000004c0| 29 3b 0a 49 46 50 20 20 | 20 20 65 6e 64 66 6e 78 |);.IFP | endfnx|
|000004d0| 3b 0a 3c 2f 50 52 45 3e | 0a 0a 3c 50 3e 0a 54 68 |;.</PRE>|..<P>.Th|
|000004e0| 65 20 61 72 67 75 6d 65 | 6e 74 73 20 61 72 65 20 |e argume|nts are |
|000004f0| 61 73 20 66 6f 6c 6c 6f | 77 73 3a 0a 3c 42 52 3e |as follo|ws:.<BR>|
|00000500| 0a 3c 49 4d 47 0a 20 20 | 53 54 59 4c 45 3d 22 22 |.<IMG. |STYLE=""|
|00000510| 20 53 52 43 3d 22 69 6d | 67 32 30 2e 70 6e 67 22 | SRC="im|g20.png"|
|00000520| 0a 20 41 4c 54 3d 22 5c | 62 65 67 69 6e 7b 64 65 |. ALT="\|begin{de|
|00000530| 73 63 72 69 62 65 7d 0a | 5c 69 74 65 6d 5b 5c 76 |scribe}.|\item[\v|
|00000540| 65 72 62 5c 76 65 72 74 | 20 61 72 67 63 5c 76 65 |erb\vert| argc\ve|
|00000550| 72 74 2f 5c 76 65 72 62 | 5c 76 65 72 74 20 61 72 |rt/\verb|\vert ar|
|00000560| 67 76 5c 76 65 72 74 3a | 5d 20 54 68 65 20 61 72 |gv\vert:|] The ar|
|00000570| 67 75 6d 65 6e 74 20 2e | 2e 2e 0a 2e 2e 2e 62 5c |gument .|......b\|
|00000580| 76 65 72 74 20 4e 55 4c | 4c 49 46 50 5c 76 65 72 |vert NUL|LIFP\ver|
|00000590| 74 20 6d 61 79 20 62 65 | 20 75 73 65 64 20 69 66 |t may be| used if|
|000005a0| 20 74 68 69 73 20 66 75 | 6e 63 74 69 6f 6e 0a 69 | this fu|nction.i|
|000005b0| 73 20 6e 6f 74 20 72 65 | 71 75 69 72 65 64 2e 0a |s not re|quired..|
|000005c0| 5c 65 6e 64 7b 64 65 73 | 63 72 69 62 65 7d 22 3e |\end{des|cribe}">|
|000005d0| 0a 3c 42 52 3e 0a 54 68 | 65 20 3c 63 6f 64 65 3e |.<BR>.Th|e <code>|
|000005e0| 63 68 61 6e 6e 65 6c 5f | 63 6f 6e 74 72 6f 6c 3c |channel_|control<|
|000005f0| 2f 63 6f 64 65 3e 20 66 | 75 6e 63 74 69 6f 6e 20 |/code> f|unction |
|00000600| 69 6e 76 6f 6b 65 73 20 | 69 74 73 20 6f 77 6e 20 |invokes |its own |
|00000610| 65 72 72 6f 72 20 68 61 | 6e 64 6c 65 72 73 0a 61 |error ha|ndlers.a|
|00000620| 6e 64 20 64 6f 65 73 20 | 6e 6f 74 20 6e 6f 72 6d |nd does |not norm|
|00000630| 61 6c 6c 79 20 72 65 74 | 75 72 6e 2e 0a 0a 3c 50 |ally ret|urn...<P|
|00000640| 3e 0a 54 68 65 20 74 77 | 6f 20 66 75 6e 63 74 69 |>.The tw|o functi|
|00000650| 6f 6e 73 20 3c 63 6f 64 | 65 3e 69 6e 69 74 66 6e |ons <cod|e>initfn|
|00000660| 78 3c 2f 63 6f 64 65 3e | 20 61 6e 64 20 3c 63 6f |x</code>| and <co|
|00000670| 64 65 3e 70 72 6f 63 66 | 6e 78 3c 2f 63 6f 64 65 |de>procf|nx</code|
|00000680| 3e 20 73 68 6f 77 6e 20 | 61 62 6f 76 65 20 61 72 |> shown |above ar|
|00000690| 65 20 74 68 65 20 6b 65 | 79 20 74 6f 20 74 68 65 |e the ke|y to the|
|000006a0| 20 63 68 61 6e 6e 65 6c | 73 0a 6f 70 65 72 61 74 | channel|s.operat|
|000006b0| 69 6f 6e 2e 20 54 68 65 | 20 69 6e 69 74 69 61 6c |ion. The| initial|
|000006c0| 69 73 61 74 69 6f 6e 20 | 66 75 6e 63 74 69 6f 6e |isation |function|
|000006d0| 20 73 68 6f 75 6c 64 20 | 62 65 20 64 65 66 69 6e | should |be defin|
|000006e0| 65 64 20 69 6e 20 74 68 | 65 0a 66 6f 6c 6c 6f 77 |ed in th|e.follow|
|000006f0| 69 6e 67 20 77 61 79 3a | 3c 50 52 45 3e 0a 69 6e |ing way:|<PRE>.in|
|00000700| 74 20 20 20 69 6e 69 74 | 66 6e 78 20 28 61 72 67 |t init|fnx (arg|
|00000710| 29 0a 73 74 72 75 63 74 | 20 74 79 70 65 5f 51 6d |).struct| type_Qm|
|00000720| 67 72 5f 43 68 61 6e 6e | 65 6c 20 2a 61 72 67 3b |gr_Chann|el *arg;|
|00000730| 0a 3c 2f 50 52 45 3e 0a | 0a 3c 50 3e 0a 54 68 65 |.</PRE>.|.<P>.The|
|00000740| 20 66 75 6e 63 74 69 6f | 6e 20 73 68 6f 75 6c 64 | functio|n should|
|00000750| 20 74 68 65 6e 20 64 65 | 63 69 64 65 20 77 68 65 | then de|cide whe|
|00000760| 74 68 65 72 20 74 68 65 | 20 67 69 76 65 6e 20 63 |ther the| given c|
|00000770| 68 61 6e 6e 65 6c 20 61 | 72 67 75 6d 65 6e 74 20 |hannel a|rgument |
|00000780| 69 73 0a 73 65 6e 73 69 | 62 6c 65 20 66 6f 72 20 |is.sensi|ble for |
|00000790| 74 68 69 73 20 63 68 61 | 6e 6e 65 6c 20 61 6e 64 |this cha|nnel and|
|000007a0| 20 72 65 74 75 72 6e 20 | 6f 6e 65 20 6f 66 20 74 | return |one of t|
|000007b0| 68 65 20 63 6f 6e 73 74 | 61 6e 74 73 20 3c 63 6f |he const|ants <co|
|000007c0| 64 65 3e 4f 4b 3c 2f 63 | 6f 64 65 3e 20 6f 72 0a |de>OK</c|ode> or.|
|000007d0| 3c 63 6f 64 65 3e 4e 4f | 54 4f 4b 3c 2f 63 6f 64 |<code>NO|TOK</cod|
|000007e0| 65 3e 2e 20 54 68 69 73 | 20 66 75 6e 63 74 69 6f |e>. This| functio|
|000007f0| 6e 20 69 73 20 6e 6f 72 | 6d 61 6c 6c 79 20 6f 6e |n is nor|mally on|
|00000800| 6c 79 20 63 61 6c 6c 65 | 64 20 6f 6e 63 65 20 62 |ly calle|d once b|
|00000810| 79 20 74 68 65 20 51 4d | 47 52 2c 0a 62 75 74 20 |y the QM|GR,.but |
|00000820| 69 6e 20 63 61 73 65 73 | 20 77 68 65 72 65 20 74 |in cases| where t|
|00000830| 68 65 20 73 61 6d 65 20 | 70 72 6f 67 72 61 6d 20 |he same |program |
|00000840| 63 61 6e 20 72 75 6e 20 | 61 73 20 61 20 6e 75 6d |can run |as a num|
|00000850| 62 65 72 20 6f 66 20 63 | 68 61 6e 6e 65 6c 73 20 |ber of c|hannels |
|00000860| 69 74 0a 6d 61 79 20 62 | 65 20 63 61 6c 6c 65 64 |it.may b|e called|
|00000870| 20 73 75 62 73 65 71 75 | 65 6e 74 6c 79 20 74 6f | subsequ|ently to|
|00000880| 20 72 65 69 6e 69 74 69 | 61 6c 69 73 65 20 74 68 | reiniti|alise th|
|00000890| 65 20 63 68 61 6e 6e 65 | 6c 20 74 6f 20 61 20 64 |e channe|l to a d|
|000008a0| 69 66 66 65 72 65 6e 74 | 0a 6d 6f 64 65 20 6f 66 |ifferent|.mode of|
|000008b0| 20 6f 70 65 72 61 74 69 | 6f 6e 2e 0a 0a 3c 50 3e | operati|on...<P>|
|000008c0| 0a 54 68 65 20 70 72 6f | 63 65 73 73 20 66 75 6e |.The pro|cess fun|
|000008d0| 63 74 69 6f 6e 20 69 73 | 20 74 68 65 20 6f 6e 65 |ction is| the one|
|000008e0| 20 74 68 61 74 20 64 6f | 65 73 20 74 68 65 20 72 | that do|es the r|
|000008f0| 65 61 6c 20 77 6f 72 6b | 20 6f 66 20 74 68 65 0a |eal work| of the.|
|00000900| 63 68 61 6e 6e 65 6c 2e | 20 49 74 20 73 68 6f 75 |channel.| It shou|
|00000910| 6c 64 20 62 65 20 64 65 | 66 69 6e 65 64 20 6c 69 |ld be de|fined li|
|00000920| 6b 65 20 74 68 69 73 3a | 3c 50 52 45 3e 0a 73 74 |ke this:|<PRE>.st|
|00000930| 72 75 63 74 20 74 79 70 | 65 5f 51 6d 67 72 5f 44 |ruct typ|e_Qmgr_D|
|00000940| 65 6c 69 76 65 72 79 53 | 74 61 74 75 73 20 2a 70 |eliveryS|tatus *p|
|00000950| 72 6f 63 65 73 73 6d 65 | 73 73 61 67 65 20 28 61 |rocessme|ssage (a|
|00000960| 72 67 29 0a 73 74 72 75 | 63 74 20 74 79 70 65 5f |rg).stru|ct type_|
|00000970| 51 6d 67 72 5f 50 72 6f | 63 4d 73 67 20 2a 61 72 |Qmgr_Pro|cMsg *ar|
|00000980| 67 3b 0a 3c 2f 50 52 45 | 3e 0a 54 68 65 20 66 75 |g;.</PRE|>.The fu|
|00000990| 6e 63 74 69 6f 6e 20 73 | 68 6f 75 6c 64 20 74 68 |nction s|hould th|
|000009a0| 65 6e 20 61 74 74 65 6d | 70 74 20 74 6f 20 70 72 |en attem|pt to pr|
|000009b0| 6f 63 65 73 73 20 74 68 | 65 20 67 69 76 65 6e 20 |ocess th|e given |
|000009c0| 6d 65 73 73 61 67 65 20 | 66 6f 72 20 74 68 65 0a |message |for the.|
|000009d0| 67 69 76 65 6e 20 72 65 | 63 69 70 69 65 6e 74 73 |given re|cipients|
|000009e0| 2e 20 54 68 69 73 20 75 | 73 75 61 6c 6c 79 20 69 |. This u|sually i|
|000009f0| 6e 76 6f 6c 76 65 73 20 | 66 69 72 73 74 20 72 65 |nvolves |first re|
|00000a00| 61 64 69 6e 67 20 74 68 | 65 20 61 64 64 72 65 73 |ading th|e addres|
|00000a10| 73 0a 63 6f 6e 74 72 6f | 6c 20 66 69 6c 65 20 67 |s.contro|l file g|
|00000a20| 69 76 65 6e 20 61 73 20 | 70 61 72 74 20 6f 66 20 |iven as |part of |
|00000a30| 74 68 65 20 73 74 72 75 | 63 74 75 72 65 20 70 61 |the stru|cture pa|
|00000a40| 73 73 65 64 2e 0a 0a 3c | 50 3e 0a 57 68 65 6e 20 |ssed...<|P>.When |
|00000a50| 74 68 65 20 70 72 6f 63 | 65 73 73 69 6e 67 20 6f |the proc|essing o|
|00000a60| 66 20 74 68 65 20 6d 65 | 73 73 61 67 65 20 68 61 |f the me|ssage ha|
|00000a70| 73 20 66 69 6e 69 73 68 | 65 64 2c 20 74 68 65 20 |s finish|ed, the |
|00000a80| 66 75 6e 63 74 69 6f 6e | 20 73 68 6f 75 6c 64 0a |function| should.|
|00000a90| 72 65 74 75 72 6e 20 61 | 20 70 6f 69 6e 74 65 72 |return a| pointer|
|00000aa0| 20 74 6f 20 61 20 6c 69 | 73 74 20 6f 66 20 72 65 | to a li|st of re|
|00000ab0| 63 69 70 69 65 6e 74 20 | 6e 75 6d 62 65 72 73 20 |cipient |numbers |
|00000ac0| 74 6f 67 65 74 68 65 72 | 20 77 69 74 68 20 61 20 |together| with a |
|00000ad0| 73 74 61 74 75 73 0a 66 | 69 65 6c 64 2e 20 54 68 |status.f|ield. Th|
|00000ae0| 69 73 20 73 74 72 75 63 | 74 75 72 65 20 69 73 20 |is struc|ture is |
|00000af0| 74 68 65 20 3c 63 6f 64 | 65 3e 74 79 70 65 5f 51 |the <cod|e>type_Q|
|00000b00| 6d 67 72 5f 44 65 6c 69 | 76 65 72 79 53 74 61 74 |mgr_Deli|veryStat|
|00000b10| 75 73 3c 2f 63 6f 64 65 | 3e 0a 73 74 72 75 63 74 |us</code|>.struct|
|00000b20| 75 72 65 2e 20 54 68 69 | 73 20 73 70 65 63 69 66 |ure. Thi|s specif|
|00000b30| 69 65 73 20 66 6f 72 20 | 65 61 63 68 20 72 65 63 |ies for |each rec|
|00000b40| 69 70 69 65 6e 74 20 77 | 68 65 74 68 65 72 20 74 |ipient w|hether t|
|00000b50| 68 65 20 6f 70 65 72 61 | 74 69 6f 6e 20 77 61 73 |he opera|tion was|
|00000b60| 0a 61 20 73 75 63 63 65 | 73 73 20 6f 72 20 66 61 |.a succe|ss or fa|
|00000b70| 69 6c 75 72 65 2e 20 54 | 68 65 20 73 74 61 74 75 |ilure. T|he statu|
|00000b80| 73 20 76 61 6c 75 65 73 | 20 61 72 65 3a 0a 3c 42 |s values| are:.<B|
|00000b90| 52 3e 0a 3c 49 4d 47 0a | 20 20 53 54 59 4c 45 3d |R>.<IMG.| STYLE=|
|00000ba0| 22 22 20 53 52 43 3d 22 | 69 6d 67 32 31 2e 70 6e |"" SRC="|img21.pn|
|00000bb0| 67 22 0a 20 41 4c 54 3d | 22 5c 62 65 67 69 6e 7b |g". ALT=|"\begin{|
|00000bc0| 64 65 73 63 72 69 62 65 | 7d 0a 5c 69 74 65 6d 5b |describe|}.\item[|
|00000bd0| 5c 76 65 72 62 5c 76 65 | 72 74 20 69 6e 74 5c 5f |\verb\ve|rt int\_|
|00000be0| 51 6d 67 72 5c 5f 73 74 | 61 74 75 73 5c 5f 73 75 |Qmgr\_st|atus\_su|
|00000bf0| 63 63 65 73 73 5c 76 65 | 72 74 3a 5d 5c 69 6e 64 |ccess\ve|rt:]\ind|
|00000c00| 65 78 7b 73 74 61 74 75 | 73 2e 2e 2e 0a 2e 2e 2e |ex{statu|s.......|
|00000c10| 65 20 4d 54 41 2e 20 54 | 68 69 73 20 63 68 61 6e |e MTA. T|his chan|
|00000c20| 6e 65 6c 20 73 68 6f 75 | 6c 64 20 62 65 20 61 74 |nel shou|ld be at|
|00000c30| 74 65 6d 70 74 65 64 20 | 61 67 61 69 6e 20 69 6e |tempted |again in|
|00000c40| 20 74 68 65 20 6e 65 61 | 72 0a 66 75 74 75 72 65 | the nea|r.future|
|00000c50| 2e 0a 5c 65 6e 64 7b 64 | 65 73 63 72 69 62 65 7d |..\end{d|escribe}|
|00000c60| 22 3e 0a 3c 42 52 3e 0a | 0a 3c 50 3e 0a 54 6f 20 |">.<BR>.|.<P>.To |
|00000c70| 61 69 64 20 69 6e 20 73 | 65 74 74 69 6e 67 20 74 |aid in s|etting t|
|00000c80| 68 65 73 65 20 76 61 6c | 75 65 73 2c 20 61 20 73 |hese val|ues, a s|
|00000c90| 65 74 20 6f 66 20 73 75 | 70 70 6f 72 74 20 72 6f |et of su|pport ro|
|00000ca0| 75 74 69 6e 65 73 20 69 | 73 20 70 72 6f 76 69 64 |utines i|s provid|
|00000cb0| 65 64 0a 69 6e 20 74 68 | 65 20 6c 69 62 72 61 72 |ed.in th|e librar|
|00000cc0| 79 2e 20 54 68 65 73 65 | 20 72 6f 75 74 69 6e 65 |y. These| routine|
|00000cd0| 73 20 61 6c 6c 20 75 70 | 64 61 74 65 20 74 68 65 |s all up|date the|
|00000ce0| 20 67 6c 6f 62 61 6c 20 | 76 61 72 69 61 62 6c 65 | global |variable|
|00000cf0| 0a 3c 63 6f 64 65 3e 64 | 65 6c 69 76 65 72 79 73 |.<code>d|eliverys|
|00000d00| 74 61 74 65 3c 2f 63 6f | 64 65 3e 20 77 68 69 63 |tate</co|de> whic|
|00000d10| 68 20 69 73 20 73 75 69 | 74 61 62 6c 65 20 61 73 |h is sui|table as|
|00000d20| 20 61 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 20 | a retur|n value |
|00000d30| 66 6f 72 20 74 68 65 0a | 70 72 6f 63 65 73 73 20 |for the.|process |
|00000d40| 66 75 6e 63 74 69 6f 6e | 2e 20 4e 6f 74 65 2c 20 |function|. Note, |
|00000d50| 68 6f 77 65 76 65 72 2c | 20 74 68 61 74 20 74 68 |however,| that th|
|00000d60| 65 20 76 61 6c 75 65 20 | 6f 66 0a 3c 63 6f 64 65 |e value |of.<code|
|00000d70| 3e 69 6e 74 5f 51 6d 67 | 72 5f 73 74 61 74 75 73 |>int_Qmg|r_status|
|00000d80| 5f 70 65 72 6d 61 6e 65 | 6e 74 46 61 69 6c 75 72 |_permane|ntFailur|
|00000d90| 65 3c 2f 63 6f 64 65 3e | 20 69 73 20 60 60 73 74 |e</code>| is ``st|
|00000da0| 69 63 6b 79 27 27 3b 20 | 74 68 69 73 20 76 61 6c |icky''; |this val|
|00000db0| 75 65 20 6d 61 79 0a 62 | 65 20 73 65 74 2c 20 62 |ue may.b|e set, b|
|00000dc0| 75 74 20 6f 6e 63 65 20 | 73 65 74 20 63 61 6e 6e |ut once |set cann|
|00000dd0| 6f 74 20 62 65 20 6f 76 | 65 72 77 72 69 74 74 65 |ot be ov|erwritte|
|00000de0| 6e 20 62 79 20 74 68 65 | 73 65 20 72 6f 75 74 69 |n by the|se routi|
|00000df0| 6e 65 73 2e 20 54 68 69 | 73 20 69 73 0a 62 65 63 |nes. Thi|s is.bec|
|00000e00| 61 75 73 65 20 6e 6f 72 | 6d 61 6c 6c 79 20 77 68 |ause nor|mally wh|
|00000e10| 65 6e 20 61 6e 20 61 64 | 64 72 65 73 73 20 69 73 |en an ad|dress is|
|00000e20| 20 6d 61 72 6b 65 64 20 | 77 69 74 68 20 74 68 69 | marked |with thi|
|00000e30| 73 20 73 74 61 74 75 73 | 2c 20 61 0a 64 65 6c 69 |s status|, a.deli|
|00000e40| 76 65 72 79 20 72 65 70 | 6f 72 74 20 69 73 20 77 |very rep|ort is w|
|00000e50| 72 69 74 74 65 6e 20 6f | 75 74 20 61 6e 64 20 74 |ritten o|ut and t|
|00000e60| 68 65 20 6d 65 73 73 61 | 67 65 20 69 73 20 75 70 |he messa|ge is up|
|00000e70| 64 61 74 65 64 20 61 63 | 63 6f 72 64 69 6e 67 6c |dated ac|cordingl|
|00000e80| 79 0a 28 73 65 65 20 53 | 65 63 74 69 6f 6e 26 6e |y.(see S|ection&n|
|00000e90| 62 73 70 3b 3c 41 20 48 | 52 45 46 3d 22 6e 6f 64 |bsp;<A H|REF="nod|
|00000ea0| 65 34 39 5f 63 74 2e 68 | 74 6d 6c 23 73 65 74 3a |e49_ct.h|tml#set:|
|00000eb0| 64 72 22 3e 33 2e 32 2e | 33 3c 2f 41 3e 20 66 6f |dr">3.2.|3</A> fo|
|00000ec0| 72 20 72 6f 75 74 69 6e | 65 73 20 74 6f 20 77 72 |r routin|es to wr|
|00000ed0| 69 74 65 20 6f 75 74 20 | 64 65 6c 69 76 65 72 79 |ite out |delivery|
|00000ee0| 20 72 65 70 6f 72 74 73 | 29 2e 0a 54 6f 20 20 73 | reports|)..To s|
|00000ef0| 65 74 20 74 68 65 20 73 | 74 61 74 75 73 20 20 74 |et the s|tatus t|
|00000f00| 68 65 6e 20 74 6f 20 73 | 6f 6d 65 74 68 69 6e 67 |hen to s|omething|
|00000f10| 20 65 6c 73 65 20 77 6f | 75 6c 64 20 63 6f 6e 66 | else wo|uld conf|
|00000f20| 75 73 65 20 74 68 65 20 | 71 75 65 75 65 0a 6d 61 |use the |queue.ma|
|00000f30| 6e 61 67 65 72 2e 20 54 | 68 65 20 72 6f 75 74 69 |nager. T|he routi|
|00000f40| 6e 65 73 20 61 72 65 20 | 61 73 20 66 6f 6c 6c 6f |nes are |as follo|
|00000f50| 77 73 3a 0a 0a 3c 50 3e | 0a 3c 42 4c 4f 43 4b 51 |ws:..<P>|.<BLOCKQ|
|00000f60| 55 4f 54 45 3e 0a 3c 41 | 20 49 44 3d 22 31 34 32 |UOTE>.<A| ID="142|
|00000f70| 32 22 3e 3c 2f 41 3e 3c | 2f 42 4c 4f 43 4b 51 55 |2"></A><|/BLOCKQU|
|00000f80| 4f 54 45 3e 3c 50 52 45 | 3e 0a 73 74 72 75 63 74 |OTE><PRE|>.struct|
|00000f90| 20 74 79 70 65 5f 51 6d | 67 72 5f 44 65 6c 69 76 | type_Qm|gr_Deliv|
|00000fa0| 65 72 79 53 74 61 74 75 | 73 20 2a 64 65 6c 69 76 |eryStatu|s *deliv|
|00000fb0| 65 72 79 5f 69 6e 69 74 | 20 28 75 73 65 72 73 29 |ery_init| (users)|
|00000fc0| 0a 73 74 72 75 63 74 20 | 74 79 70 65 5f 51 6d 67 |.struct |type_Qmg|
|00000fd0| 72 5f 55 73 65 72 4c 69 | 73 74 20 2a 75 73 65 72 |r_UserLi|st *user|
|00000fe0| 73 3b 0a 3c 2f 50 52 45 | 3e 0a 0a 3c 50 3e 0a 54 |s;.</PRE|>..<P>.T|
|00000ff0| 68 69 73 20 72 6f 75 74 | 69 6e 65 20 69 6e 69 74 |his rout|ine init|
|00001000| 69 61 6c 69 73 65 73 20 | 74 68 65 20 73 74 72 75 |ialises |the stru|
|00001010| 63 74 75 72 65 2e 20 49 | 74 20 64 6f 65 73 20 62 |cture. I|t does b|
|00001020| 79 20 61 6c 6c 6f 63 61 | 74 69 6e 67 20 61 6e 0a |y alloca|ting an.|
|00001030| 65 6c 65 6d 65 6e 74 20 | 66 6f 72 20 65 61 63 68 |element |for each|
|00001040| 20 6f 66 20 74 68 65 20 | 75 73 65 72 73 20 70 61 | of the |users pa|
|00001050| 73 73 65 64 20 69 6e 20 | 74 68 65 20 61 72 67 75 |ssed in |the argu|
|00001060| 6d 65 6e 74 2e 20 54 68 | 65 20 73 69 6e 67 6c 65 |ment. Th|e single|
|00001070| 0a 70 61 72 61 6d 65 74 | 65 72 20 69 73 20 74 68 |.paramet|er is th|
|00001080| 65 20 6c 69 73 74 20 6f | 66 20 75 73 65 72 73 20 |e list o|f users |
|00001090| 70 61 73 73 65 64 20 6f | 76 65 72 20 62 79 20 74 |passed o|ver by t|
|000010a0| 68 65 20 51 4d 47 52 2e | 0a 0a 3c 50 3e 0a 3c 42 |he QMGR.|..<P>.<B|
|000010b0| 4c 4f 43 4b 51 55 4f 54 | 45 3e 0a 3c 41 20 49 44 |LOCKQUOT|E>.<A ID|
|000010c0| 3d 22 31 34 32 37 22 3e | 3c 2f 41 3e 3c 2f 42 4c |="1427">|</A></BL|
|000010d0| 4f 43 4b 51 55 4f 54 45 | 3e 3c 50 52 45 3e 0a 73 |OCKQUOTE|><PRE>.s|
|000010e0| 74 72 75 63 74 20 74 79 | 70 65 5f 51 6d 67 72 5f |truct ty|pe_Qmgr_|
|000010f0| 44 65 6c 69 76 65 72 79 | 53 74 61 74 75 73 20 0a |Delivery|Status .|
|00001100| 20 20 20 20 20 20 20 2a | 64 65 6c 69 76 65 72 79 | *|delivery|
|00001110| 5f 73 65 74 73 74 61 74 | 65 20 28 72 6e 6f 2c 20 |_setstat|e (rno, |
|00001120| 76 61 6c 2c 20 72 65 61 | 73 6f 6e 29 0a 69 6e 74 |val, rea|son).int|
|00001130| 20 20 72 6e 6f 2c 20 76 | 61 6c 3b 0a 63 68 61 72 | rno, v|al;.char|
|00001140| 20 2a 72 65 61 73 6f 6e | 3b 0a 3c 2f 50 52 45 3e | *reason|;.</PRE>|
|00001150| 0a 0a 3c 50 3e 0a 54 68 | 69 73 20 72 6f 75 74 69 |..<P>.Th|is routi|
|00001160| 6e 65 20 73 65 74 73 20 | 74 68 65 20 76 61 6c 75 |ne sets |the valu|
|00001170| 65 20 6f 66 20 74 68 65 | 20 67 69 76 65 6e 20 72 |e of the| given r|
|00001180| 65 63 69 70 69 65 6e 74 | 20 6e 75 6d 62 65 72 20 |ecipient| number |
|00001190| 74 6f 20 74 68 65 0a 69 | 6e 64 69 63 61 74 65 64 |to the.i|ndicated|
|000011a0| 20 76 61 6c 75 65 20 69 | 6e 20 74 68 65 20 67 6c | value i|n the gl|
|000011b0| 6f 62 61 6c 20 73 74 72 | 75 63 74 75 72 65 20 28 |obal str|ucture (|
|000011c0| 77 69 74 68 20 74 68 65 | 20 61 62 6f 76 65 20 70 |with the| above p|
|000011d0| 72 6f 76 69 73 6f 29 2e | 20 49 74 0a 61 6c 73 6f |roviso).| It.also|
|000011e0| 20 69 6e 63 6c 75 64 65 | 73 20 61 20 73 74 72 69 | include|s a stri|
|000011f0| 6e 67 20 69 6e 64 69 63 | 61 74 69 6e 67 20 74 68 |ng indic|ating th|
|00001200| 65 20 72 65 61 73 6f 6e | 20 66 6f 72 20 66 61 69 |e reason| for fai|
|00001210| 6c 75 72 65 2c 20 69 66 | 20 66 61 69 6c 75 72 65 |lure, if| failure|
|00001220| 0a 6f 63 63 75 72 72 65 | 64 2e 20 54 68 69 73 20 |.occurre|d. This |
|00001230| 73 74 72 69 6e 67 20 69 | 73 20 70 61 73 73 65 64 |string i|s passed|
|00001240| 20 62 61 63 6b 20 74 6f | 20 74 68 65 20 51 4d 47 | back to| the QMG|
|00001250| 52 20 66 6f 72 20 64 69 | 73 70 6c 61 79 20 62 79 |R for di|splay by|
|00001260| 0a 74 68 65 20 4d 54 41 | 63 6f 6e 73 6f 6c 65 2e |.the MTA|console.|
|00001270| 20 49 74 20 73 68 6f 75 | 6c 64 20 62 65 20 73 65 | It shou|ld be se|
|00001280| 74 20 74 6f 20 74 68 65 | 20 63 6f 6e 73 74 61 6e |t to the| constan|
|00001290| 74 20 3c 63 6f 64 65 3e | 4e 55 4c 4c 43 50 3c 2f |t <code>|NULLCP</|
|000012a0| 63 6f 64 65 3e 0a 69 66 | 20 74 68 65 20 72 65 63 |code>.if| the rec|
|000012b0| 69 70 69 65 6e 74 20 77 | 61 73 20 68 61 6e 64 6c |ipient w|as handl|
|000012c0| 65 64 20 73 75 63 63 65 | 73 73 66 75 6c 6c 79 20 |ed succe|ssfully |
|000012d0| 6f 72 20 6e 6f 20 64 69 | 61 67 6e 6f 73 74 69 63 |or no di|agnostic|
|000012e0| 20 72 65 61 73 6f 6e 20 | 69 73 20 61 76 61 69 6c | reason |is avail|
|000012f0| 61 62 6c 65 2e 0a 0a 3c | 50 3e 0a 3c 42 4c 4f 43 |able...<|P>.<BLOC|
|00001300| 4b 51 55 4f 54 45 3e 0a | 3c 41 20 49 44 3d 22 31 |KQUOTE>.|<A ID="1|
|00001310| 34 33 32 22 3e 3c 2f 41 | 3e 3c 2f 42 4c 4f 43 4b |432"></A|></BLOCK|
|00001320| 51 55 4f 54 45 3e 3c 50 | 52 45 3e 0a 73 74 72 75 |QUOTE><P|RE>.stru|
|00001330| 63 74 20 74 79 70 65 5f | 51 6d 67 72 5f 44 65 6c |ct type_|Qmgr_Del|
|00001340| 69 76 65 72 79 53 74 61 | 74 75 73 20 0a 20 20 20 |iverySta|tus . |
|00001350| 20 20 20 20 2a 64 65 6c | 69 76 65 72 79 5f 73 65 | *del|ivery_se|
|00001360| 74 61 6c 6c 73 74 61 74 | 65 20 28 76 61 6c 2c 20 |tallstat|e (val, |
|00001370| 72 65 61 73 6f 6e 29 0a | 69 6e 74 20 20 76 61 6c |reason).|int val|
|00001380| 3b 0a 63 68 61 72 20 2a | 72 65 61 73 6f 6e 3b 0a |;.char *|reason;.|
|00001390| 3c 2f 50 52 45 3e 0a 0a | 3c 50 3e 0a 54 68 69 73 |</PRE>..|<P>.This|
|000013a0| 20 72 6f 75 74 69 6e 65 | 20 73 65 74 73 20 61 6c | routine| sets al|
|000013b0| 6c 20 75 73 65 72 73 27 | 20 73 74 61 74 75 73 20 |l users'| status |
|000013c0| 74 6f 20 74 68 65 20 67 | 69 76 65 6e 20 76 61 6c |to the g|iven val|
|000013d0| 75 65 2e 20 54 68 69 73 | 20 69 73 20 75 73 65 66 |ue. This| is usef|
|000013e0| 75 6c 0a 77 68 65 6e 20 | 61 20 63 6f 6e 6e 65 63 |ul.when |a connec|
|000013f0| 74 69 6f 6e 20 63 61 6e | 6e 6f 74 20 62 65 20 65 |tion can|not be e|
|00001400| 73 74 61 62 6c 69 73 68 | 65 64 2c 20 66 6f 72 20 |stablish|ed, for |
|00001410| 69 6e 73 74 61 6e 63 65 | 2c 20 61 6e 64 20 61 6c |instance|, and al|
|00001420| 6c 20 72 65 63 69 70 69 | 65 6e 74 73 0a 6d 75 73 |l recipi|ents.mus|
|00001430| 74 20 62 65 20 70 75 74 | 20 69 6e 20 74 68 65 20 |t be put| in the |
|00001440| 73 61 6d 65 20 73 74 61 | 74 65 20 28 61 67 61 69 |same sta|te (agai|
|00001450| 6e 2c 20 74 68 65 20 61 | 62 6f 76 65 20 70 72 6f |n, the a|bove pro|
|00001460| 76 69 73 6f 20 61 62 6f | 75 74 20 64 65 6c 69 76 |viso abo|ut deliv|
|00001470| 65 72 79 0a 72 65 70 6f | 72 74 73 20 68 6f 6c 64 |ery.repo|rts hold|
|00001480| 73 29 2e 20 54 68 65 20 | 72 65 61 73 6f 6e 20 66 |s). The |reason f|
|00001490| 69 65 6c 64 20 69 73 20 | 74 68 65 20 73 61 6d 65 |ield is |the same|
|000014a0| 20 61 73 20 61 62 6f 76 | 65 2e 0a 0a 3c 50 3e 0a | as abov|e...<P>.|
|000014b0| 4f 63 63 61 73 69 6f 6e | 61 6c 6c 79 20 69 74 20 |Occasion|ally it |
|000014c0| 6d 61 79 20 6f 63 63 75 | 72 20 74 68 61 74 20 61 |may occu|r that a|
|000014d0| 20 70 65 72 6d 61 6e 65 | 6e 74 20 66 61 69 6c 75 | permane|nt failu|
|000014e0| 72 65 20 69 73 20 72 65 | 63 65 69 76 65 64 20 62 |re is re|ceived b|
|000014f0| 75 74 20 69 74 0a 69 73 | 20 6e 6f 74 20 70 6f 73 |ut it.is| not pos|
|00001500| 73 69 62 6c 65 20 74 6f | 20 77 72 69 74 65 20 61 |sible to| write a|
|00001510| 20 64 65 6c 69 76 65 72 | 79 20 72 65 70 6f 72 74 | deliver|y report|
|00001520| 20 28 65 2e 67 2e 2c 20 | 61 20 66 75 6c 6c 20 64 | (e.g., |a full d|
|00001530| 69 73 6b 29 2e 20 49 6e | 20 74 68 69 73 0a 63 61 |isk). In| this.ca|
|00001540| 73 65 20 74 68 65 20 61 | 64 64 72 65 73 73 20 66 |se the a|ddress f|
|00001550| 69 6c 65 20 73 68 6f 75 | 6c 64 20 6e 6f 74 20 62 |ile shou|ld not b|
|00001560| 65 20 75 70 64 61 74 65 | 64 20 61 6e 64 20 74 68 |e update|d and th|
|00001570| 65 20 44 52 20 73 74 61 | 74 75 73 20 73 68 6f 75 |e DR sta|tus shou|
|00001580| 6c 64 0a 62 65 20 73 65 | 74 20 74 6f 20 6d 65 73 |ld.be se|t to mes|
|00001590| 73 61 67 65 20 66 61 69 | 6c 75 72 65 20 28 74 68 |sage fai|lure (th|
|000015a0| 65 20 6e 65 78 74 20 72 | 65 74 72 79 20 73 68 6f |e next r|etry sho|
|000015b0| 75 6c 64 20 61 6c 73 6f | 20 67 69 76 65 20 61 20 |uld also| give a |
|000015c0| 44 52 20 61 6e 64 0a 74 | 68 65 6e 20 68 6f 70 65 |DR and.t|hen hope|
|000015d0| 66 75 6c 6c 79 20 61 20 | 72 65 70 6f 72 74 20 63 |fully a |report c|
|000015e0| 61 6e 20 62 65 20 77 72 | 69 74 74 65 6e 29 2e 20 |an be wr|itten). |
|000015f0| 54 6f 20 61 69 64 20 69 | 6e 20 72 65 73 65 74 74 |To aid i|n resett|
|00001600| 69 6e 67 20 74 68 65 73 | 65 0a 76 61 72 69 61 62 |ing thes|e.variab|
|00001610| 6c 65 73 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |les the |followin|
|00001620| 67 20 70 72 6f 63 65 64 | 75 72 65 20 69 73 20 75 |g proced|ure is u|
|00001630| 73 65 66 75 6c 2e 0a 0a | 3c 50 3e 0a 3c 42 4c 4f |seful...|<P>.<BLO|
|00001640| 43 4b 51 55 4f 54 45 3e | 0a 3c 41 20 49 44 3d 22 |CKQUOTE>|.<A ID="|
|00001650| 31 34 33 37 22 3e 3c 2f | 41 3e 3c 2f 42 4c 4f 43 |1437"></|A></BLOC|
|00001660| 4b 51 55 4f 54 45 3e 3c | 50 52 45 3e 0a 73 74 72 |KQUOTE><|PRE>.str|
|00001670| 75 63 74 20 74 79 70 65 | 5f 51 6d 67 72 5f 44 65 |uct type|_Qmgr_De|
|00001680| 6c 69 76 65 72 79 53 74 | 61 74 75 73 0a 20 20 20 |liverySt|atus. |
|00001690| 20 20 20 20 2a 64 65 6c | 69 76 65 72 79 5f 72 65 | *del|ivery_re|
|000016a0| 73 65 74 44 52 73 20 28 | 76 61 6c 29 0a 69 6e 74 |setDRs (|val).int|
|000016b0| 20 20 20 20 20 76 61 6c | 3b 0a 3c 2f 50 52 45 3e | val|;.</PRE>|
|000016c0| 0a 0a 3c 50 3e 0a 54 68 | 65 20 61 72 67 75 6d 65 |..<P>.Th|e argume|
|000016d0| 6e 74 20 69 73 20 74 68 | 65 20 73 74 61 74 65 20 |nt is th|e state |
|000016e0| 74 6f 20 73 65 74 20 74 | 68 65 20 44 52 20 76 61 |to set t|he DR va|
|000016f0| 6c 75 65 73 20 74 6f 20 | 28 6e 65 61 72 6c 79 20 |lues to |(nearly |
|00001700| 61 6c 77 61 79 73 0a 3c | 42 52 3e 3c 63 6f 64 65 |always.<|BR><code|
|00001710| 3e 69 6e 74 5f 51 6d 67 | 72 5f 53 74 61 74 75 73 |>int_Qmg|r_Status|
|00001720| 5f 6d 65 73 73 61 67 65 | 46 61 69 6c 75 72 65 3c |_message|Failure<|
|00001730| 2f 63 6f 64 65 3e 29 2e | 0a 0a 3c 50 3e 0a 54 68 |/code>).|..<P>.Th|
|00001740| 65 20 74 65 72 6d 69 6e | 61 74 69 6f 6e 20 66 75 |e termin|ation fu|
|00001750| 6e 63 74 69 6f 6e 2c 20 | 69 66 20 75 73 65 64 2c |nction, |if used,|
|00001760| 20 73 68 6f 75 6c 64 20 | 62 65 20 64 65 66 69 6e | should |be defin|
|00001770| 65 64 20 61 73 20 66 6f | 6c 6c 6f 77 73 2e 3c 50 |ed as fo|llows.<P|
|00001780| 52 45 3e 0a 69 6e 74 20 | 65 6e 64 66 75 63 74 69 |RE>.int |endfucti|
|00001790| 6f 6e 20 28 29 0a 3c 2f | 50 52 45 3e 0a 0a 3c 50 |on ().</|PRE>..<P|
|000017a0| 3e 0a 54 68 69 73 20 72 | 6f 75 74 69 6e 65 20 69 |>.This r|outine i|
|000017b0| 73 20 75 73 65 64 20 74 | 6f 20 63 6c 6f 73 65 20 |s used t|o close |
|000017c0| 64 6f 77 6e 20 61 6e 79 | 74 68 69 6e 67 20 72 65 |down any|thing re|
|000017d0| 71 75 69 72 65 64 20 62 | 65 66 6f 72 65 20 65 78 |quired b|efore ex|
|000017e0| 69 74 69 6e 67 0a 74 68 | 65 20 70 72 6f 67 72 61 |iting.th|e progra|
|000017f0| 6d 2e 20 54 68 65 20 63 | 61 6c 6c 69 6e 67 20 72 |m. The c|alling r|
|00001800| 6f 75 74 69 6e 65 20 77 | 69 6c 6c 20 65 78 65 63 |outine w|ill exec|
|00001810| 75 74 65 20 74 68 69 73 | 20 66 75 6e 63 74 69 6f |ute this| functio|
|00001820| 6e 20 62 65 66 6f 72 65 | 20 73 65 6e 64 69 6e 67 |n before| sending|
|00001830| 0a 74 68 65 20 66 69 6e | 61 6c 20 64 69 73 63 6f |.the fin|al disco|
|00001840| 6e 6e 65 63 74 20 74 6f | 20 74 68 65 20 51 4d 47 |nnect to| the QMG|
|00001850| 52 20 61 6e 64 20 65 78 | 69 74 69 6e 67 2e 0a 0a |R and ex|iting...|
|00001860| 3c 50 3e 0a 0a 3c 48 52 | 3e 0a 0a 3c 2f 42 4f 44 |<P>..<HR|>..</BOD|
|00001870| 59 3e 0a 3c 2f 48 54 4d | 4c 3e 0a |Y>.</HTM|L>. |
+--------+-------------------------+-------------------------+--------+--------+